home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / database / mm_804.zip / IMPORTF.DOC < prev    next >
Text File  |  1996-09-01  |  5KB  |  119 lines
  1.  
  2.  
  3.                 MEAL-MASTER IMPORT FILE SPECIFICATIONS
  4.  
  5.  
  6. The Meal-Master import function is designed to import recipes that
  7. were exported from the program.  However, the export format is a
  8. simple text file that can be created by most text editor programs.
  9. Many people have found that recipes from other sources can be edited
  10. to look like a MM export file, allowing them to be imported to MM with
  11. little or no retyping.  The format required is described below.
  12.  
  13. FIXED FORMAT (LINES 1 THROUGH 6)
  14.  
  15.   Line 1  The first line of a valid recipe is a "recipe header" line.
  16.           This line must begin with at least 5 hyphens ('-----'), and
  17.           must contain the words "Meal-Master" somewhere on the line.
  18.           Any lines found prior to this "recipe header" line will be
  19.           ignored by Meal-Master.
  20.           
  21.           (Note: If this line is missing, Meal-Master will attempt to
  22.           locate the "Title: " line described below, and continue with
  23.           the import process.  However, it is recommended that header
  24.           lines be used when possible)
  25.  
  26.   Line 2  The word "Title:" must begin the line in any position before
  27.           column 7, and be followed by one blank space.  The recipe
  28.           title must start after the blank space, and may be a maximum
  29.           of 60 characters in length.
  30.  
  31.   Line 3  The word "Categories:" must begin the line, in any position,
  32.           and be followed by one blank space.  A maximum of 5 category
  33.           names may be entered, beginning after the blank space.  A
  34.           comma should immediately follow each category name except
  35.           the last one; for example "Cakes, Desserts".  Category names
  36.           should start with a capital letter, with the remaining
  37.           characters in lower case letters.
  38.  
  39.   Line 4  A numeric quantity between 1 and 9999 (number of servings)
  40.           must appear somewhere on this line.
  41.  
  42.  
  43. VARIABLE FORMAT - LINES 5 AND GREATER
  44.  
  45.   Beginning with line 5, Meal-Master will attempt to identify each
  46.   line as being an ingredient line, direction line, or the "end of
  47.   recipe" trailer line.
  48.  
  49.   If a line is found that starts with 5 hyphens, and contains no
  50.   characters other than hyphens and spaces, the program considers this
  51.   the "end of recipe" trailer line.  It will store the current recipe
  52.   and begin searching for another "recipe header" as described in
  53.   "Line 1" above.
  54.  
  55.   If all the following are true, the line will be interpreted as an
  56.   ingredient and loaded into Meal-Master:
  57.  
  58.      1) Positions 1-7 contain a valid numeric quantity, either
  59.         expressed as a whole number, decimal fraction, or common
  60.         fraction, or are blank.
  61.  
  62.  
  63.      2) Positions 9-10 contain one of the valid Meal-Master unit of
  64.         measure codes, including blanks. (see list in program).
  65.  
  66.      3) Positions 12-39 contain text for an ingredient name, or a "-"
  67.         in position 12 and text in positions 13-39 (the latter is a
  68.         "continuation" line for the previous ingredient name).
  69.  
  70.  
  71.      NOTE: Beginning with v8.03, Meal-Master will attempt to align
  72.            the quantity, unit, and name information prior to import.
  73.            This means that ingredient lines do not have to follow the
  74.            column alignment above, as Meal-Master will automatically
  75.            align the quantity, unit, and name fields as long as they
  76.            contain valid data.
  77.  
  78.  
  79.   If all the following are true, the line will be interpreted as an
  80.   ingredient heading line:
  81.  
  82.      1) Positions 1-5 contain hyphens ("-----").
  83.  
  84.      2) The line is at least 40 characters long.
  85.  
  86.      3) The center three characters of the line are not blank or
  87.         hyphens.
  88.  
  89.      Note: The easiest way to format a line that will be accepted as a
  90.         heading is to start with 5 hyphens, then the heading text,
  91.         then some other special character (like "=" or "@") to at
  92.         least position 40.
  93.  
  94.   If the line does not qualify as an ingredient line, heading line, or
  95.   end of recipe line, as specified above, data in positions 3-77 (or
  96.   1-75 if positions 1-2 are non-blank) will be imported as a direction
  97.   line.
  98.  
  99.   Note: One of the most common errors in formatting a recipe for
  100.   import is an ingredient line that has been improperly formatted.
  101.   When this is encountered, the line is usually interpreted as a
  102.   direction line by the program.  To help guard against this, the
  103.   program will display an error message if it finds a line that
  104.   appears to be a direction line FOLLOWED by a valid ingredient line.
  105.  
  106.   Note: A less common error is starting a direction line in positions
  107.   12 or 13.  Such a line "looks" like an ingredient line with no
  108.   quantity or unit of measure, so an error message is given if it is
  109.   found in the Direction section.  Make sure that direction lines
  110.   start before column 12 or after column 13.
  111.  
  112. Files can contain multiple recipes, so long as each begins with a
  113. "header line" and ends with a "trailer" line.  Any text in the file
  114. that is not between the header and trailer lines is ignored.
  115.  
  116. NOTE:  THIS SPECIFICATION IS ONLY VALID FOR MEAL-MASTER VERSION 7.0
  117.        AND HIGHER, AND WILL NOT WORK PROPERLY WITH EARLIER VERSIONS.
  118.        PLEASE OBTAIN VERSION 7.0 OR GREATER FOR PROPER RESULTS!
  119.